home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_urt.idb / usr / freeware / catman / u_man / cat1 / getx11.Z / getx11
Encoding:
Text File  |  1999-01-26  |  13.1 KB  |  331 lines
  1.  
  2.  
  3.  
  4.      GGGGEEEETTTTXXXX11111111((((1111))))             1111 ((((JJJJaaaannnn 22228888,,,,    1111999999990000))))             GGGGEEEETTTTXXXX11111111((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       getx11 - get RLE images to an    X11 display
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       ggggeeeettttxxxx11111111 [ ----==== _w_i_n_d_o_w__g_e_o_m_e_t_r_y ]    [ ----aaaa ] [ ----dddd _d_i_s_p_l_a_y ] [    ----DDDD ] [
  13.            ----ffff ] [ ----gggg _d_i_s_p_l_a_y__g_a_m_m_a ] [ ----{{{{iiiiIIII}}}} _i_m_a_g_e__g_a_m_m_a ] [ ----jjjj ]
  14.            [ ----mmmm [ _m_a_x_f_r_a_m_e_s/_s_e_c ] ]    [ ----nnnn _l_e_v_e_l_s ] [    ----ssss ] [ ----tttt
  15.            _t_i_t_l_e ] [ ----vvvv ] [    ----{{{{wwwwWWWW}}}} ]    [ ----xxxx _v_i_s_u_a_l_t_y_p_e    ] [ _i_n_f_i_l_e ...
  16.            ]
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.       This program displays    an _R_L_E(5) file on an _X_1_1 display.  It
  20.       uses a dithering technique to    take a full-color or gray
  21.       scale    image into the limited number of colors    typically
  22.       available under _X.  Its default behavior is to try to
  23.       display the image in color with as many brightness levels as
  24.       possible (except on a    one bit    deep display).    Several    _g_e_t_x_1_1
  25.       processes running simultaneously with    the same color
  26.       resolution will share    color map entries.
  27.  
  28.       _G_e_t_x_1_1 uses the standard _X window creation procedure to
  29.       create a window with a location and size specified by    the
  30.       user,    with the restriction that the window must be at    least
  31.       as large as the input    image.    If the window is turned    into
  32.       an icon, a smaller version of    the image will be displayed in
  33.       the icon.
  34.  
  35.       If the input image has only a    single channel,    and has    a
  36.       color    map, then this color map will be loaded    directly (if
  37.       possible) instead of using the normal    dithering process.
  38.       Many images will look    better if pre-processed    by _m_c_u_t(1) or
  39.       _r_l_e_q_u_a_n_t(1), both of which produce images reduced to a
  40.       single channel with a    colormap.  This    is because the colors
  41.       that are used    to display the image are chosen    to be a    good
  42.       set of colors    for that particular image, rather than a set
  43.       of colors that are mediocre for all images.  The color map
  44.       so created will not be shared    with other windows.  The
  45.       picture comment _c_o_l_o_r_m_a_p__l_e_n_g_t_h specifies the    exact number
  46.       of useful entries in the input color map.  If    this is
  47.       significantly    less than 256, this can    save space in the
  48.       shared X color map.
  49.  
  50.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  51.       ----==== _w_i_n_d_o_w__g_e_o_m_e_t_r_y
  52.            Specify the geometry of the window in which the image
  53.            will be displayed.  This    is useful mostly for giving
  54.            the location of the window, as the size of the window
  55.            will be at least    as large as the    size of    the image.
  56.  
  57.       ----aaaa   "As is",    suppress dithering.
  58.  
  59.       ----dddd _d_i_s_p_l_a_y
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 12/1/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      GGGGEEEETTTTXXXX11111111((((1111))))             1111 ((((JJJJaaaannnn 22228888,,,,    1111999999990000))))             GGGGEEEETTTTXXXX11111111((((1111))))
  71.  
  72.  
  73.  
  74.            Give the    name of    the _X display to display the image on.
  75.            Defaults    to the value of    the environment    variable
  76.            _D_I_S_P_L_A_Y.
  77.  
  78.       ----DDDD   "Debug mode".  The operations in    the input _R_L_E(5) file
  79.            will be printed as they are read.
  80.  
  81.       ----ffff   "No fork."  Normally, _g_e_t_x_1_1 will fork itself after
  82.            putting the image on the    screen,    so that    the parent
  83.            process may return the shell, leaving an    "invisible"
  84.            child to    keep the image refreshed.  If ----ffff is specified,
  85.            getx11 will not exit to the shell until the image is
  86.            removed.
  87.  
  88.       ----gggg _d_i_s_p_l_a_y__g_a_m_m_a
  89.            Specify the gamma of the    _X display monitor.  The
  90.            default value is    2.5, suitable for most color TV
  91.            monitors    (this is the gamma value assumed by the    NTSC
  92.            video standard).
  93.  
  94.       ----iiii _i_m_a_g_e__g_a_m_m_a
  95.            Specify the gamma (contrast) of the image.  A low
  96.            contrast    image, suited for direct display without
  97.            compensation on a high contrast monitor (as most
  98.            monitors    are) will have a gamma of less than one.  The
  99.            default image gamma is 1.0.  Image gamma    may also be
  100.            specified by a picture comment in the _R_L_E (_5) file of
  101.            the form    iiiimmmmaaaaggggeeee____ggggaaaammmmmmmmaaaa====_g_a_m_m_a.  The    command    line argument
  102.            will override the value in the file if specified.  The
  103.            dithering process assumes that the incoming image has a
  104.            gamma of    1.0 (i.e., a 200 in the    input represents an
  105.            intensity twice that of a 100.)    If this    is not the
  106.            case, the input values must be adjusted before
  107.            dithering.
  108.  
  109.       ----IIII _i_m_a_g_e__g_a_m_m_a
  110.            An alternate method of specifying the image gamma, the
  111.            number following    ----IIII is the gamma    of the display for
  112.            which the image was originally computed (and is
  113.            therefore 1.0 divided by    the actual gamma of the
  114.            image).    Image display gamma may    also be    specified by a
  115.            picture comment in the _R_L_E (_5) file of the form
  116.            ddddiiiissssppppllllaaaayyyy____ggggaaaammmmmmmmaaaa====_g_a_m_m_a.  The command line argument will
  117.            override    the value in the file if specified.
  118.  
  119.       ----jjjj   "Jump mode".  When reading an image from    the standard
  120.            input, each scan    line is    normally displayed as soon as
  121.            it is read.  This allows    a user to monitor the progress
  122.            of an image generating program, for example (common
  123.            usage is    "tail -f image.rle | getx11").    Images read
  124.            directly    from files are only updated after every    10
  125.            lines are read to improve the display speed.  This
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 12/1/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      GGGGEEEETTTTXXXX11111111((((1111))))             1111 ((((JJJJaaaannnn 22228888,,,,    1111999999990000))))             GGGGEEEETTTTXXXX11111111((((1111))))
  137.  
  138.  
  139.  
  140.            behavior    can be forced for the standard input by
  141.            specifying jump mode.
  142.  
  143.       ----mmmm [ _m_a_x_f_r_a_m_e_s/_s_e_c ]
  144.            "Movie mode."  Optional argument    is maximum rate    at
  145.            which movies will play, in frames per second.
  146.  
  147.       ----nnnn _l_e_v_e_l_s
  148.            Specify the number of gray or color levels to be    used
  149.            in the dithering    process.  If not this many levels are
  150.            available, _g_e_t_x_1_1 will try successively fewer levels
  151.            until it    is able    to allocate enough color map entries.
  152.  
  153.       ----ssss   "Stingy mode".  Normally, _g_e_t_x_1_1    allocates an X server
  154.            pixmap for each image to    speed up the window refresh.
  155.            If many images are displayed, the server    may run    out of
  156.            memory to store these pixmaps (or its virtual memory
  157.            size may    get very large).  Stingy mode suppresses
  158.            pixmap allocation (except in movie mode,    where the
  159.            pixmaps are necessary for reasonable performance).
  160.  
  161.       ----tttt _t_i_t_l_e
  162.            The window name for an image window normally comes from
  163.            the input file name or a    iiiimmmmaaaaggggeeee____ttttiiiittttlllleeee====_t_i_t_l_e comment in
  164.            the RLE file.  The window name can be forced to a
  165.            particular string with this option.
  166.  
  167.       ----vvvv   Verbose.     (But less so than with    ----DDDD....))))
  168.  
  169.       ----wwww   This flag forces    _g_e_t_x_1_1 to produce a gray scale
  170.            (black-and-white) dithered image    instead    of a color
  171.            image.  Color input will    be transformed to black    and
  172.            white via the _N_T_S_C _Y transform.    On a low color
  173.            resolution display (a display with only 4 bits, for
  174.            example), this will produce a much smoother looking
  175.            image than color    dithering.  It may be used in
  176.            conjunction with    ----nnnn to produce an image with a
  177.            specified number    of gray    levels.
  178.  
  179.       ----WWWW   This flag forces    _g_e_t_x_1_1 to display the image as a
  180.            bitonal black and white bitmap image.  This is the only
  181.            mode available on monochrome (non gray scale) displays
  182.            (and is the default there).  Black pixels will be
  183.            displayed using the _B_l_a_c_k_P_i_x_e_l(3X) value    and white with
  184.            the _W_h_i_t_e_P_i_x_e_l(3X) value    (note that these may not be
  185.            black and white on certain displays, or when they have
  186.            been modified by    the user.)
  187.  
  188.       ----xxxx _v_i_s_u_a_l__t_y_p_e
  189.            Specify X visual    type to    be used.  The value may    be a
  190.            string or a number.  This number    is assumed to be an
  191.            integer between 0 and 5,    denoting
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 12/1/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      GGGGEEEETTTTXXXX11111111((((1111))))             1111 ((((JJJJaaaannnn 22228888,,,,    1111999999990000))))             GGGGEEEETTTTXXXX11111111((((1111))))
  203.  
  204.  
  205.  
  206.            ssssttttaaaattttiiiiccccggggrrrraaaayyyy(0),ggggrrrraaaayyyyssssccccaaaalllleeee(1),
  207.            ppppsssseeeeuuuuddddooooccccoooolllloooorrrr(2),ssssttttaaaattttiiiiccccccccoooolllloooorrrr(3), ttttrrrruuuueeeeccccoooolllloooorrrr(4), or
  208.            ddddiiiirrrreeeeccccttttccccoooolllloooorrrr(5).    The string must    match one of these
  209.            visual types (any capitalization    is ignored).
  210.  
  211.       _i_n_f_i_l_e ...
  212.            Name(s) of the _R_L_E(5) file(s) to    display.  If not
  213.            specified, the image will be read from the standard
  214.            input.  In movie    mode, you get one window, and zooming
  215.            is disabled.  In    normal mode, you get one window    per
  216.            image.
  217.  
  218.      MMMMoooouuuusssseeee////kkkkeeeeyyyy aaaaccccttttiiiioooonnnnssss ((((nnnnoooorrrrmmmmaaaallll mmmmooooddddeeee))))
  219.       Mouse    1 (left):     Increase zoom factor by 1, center    on
  220.                   this pixel.
  221.  
  222.       Mouse    2 (middle):   Recenter on this pixel.
  223.  
  224.       Mouse    3 (right):    Decrease zoom factor by 1, center    on
  225.                   this pixel.
  226.  
  227.       Shift    mouse 1:      Show value at this pixel.     In B&W, just
  228.                   shows intensity.
  229.  
  230.       Shift    mouse 2:      Toggle between zoomed and    unzoomed.
  231.  
  232.       q,Q,^C:          Quit.
  233.  
  234.       1,2,3,4,5,6,7,8,9:  Set zoom factor.
  235.  
  236.       Arrow    keys:          Move image (when zoomed).     Shifted moves
  237.                   faster.
  238.  
  239.      MMMMoooouuuusssseeee////kkkkeeeeyyyy aaaaccccttttiiiioooonnnnssss ((((mmmmoooovvvviiiieeee mmmmooooddddeeee))))
  240.       Mouse    1:          Run movie    forward.
  241.  
  242.       Shift    Mouse 1:      Run movie    continuously in    current
  243.                   direction.
  244.  
  245.       Mouse    2:          Step movie one frame in current
  246.                   direction.
  247.  
  248.       Shift    Mouse 2:      Set movie    speed by moving    mouse "up" and
  249.                   "down".  The speed chosen    is displayed
  250.                   in the upper right corner    of the window.
  251.  
  252.       Mouse    3:          Run movie    backward.
  253.  
  254.       space:          Flip one frame in    current    direction.
  255.  
  256.       b:              "Bounce" image - run it continuously
  257.                   forwards,    then backwards,    then forwards,
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 12/1/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      GGGGEEEETTTTXXXX11111111((((1111))))             1111 ((((JJJJaaaannnn 22228888,,,,    1111999999990000))))             GGGGEEEETTTTXXXX11111111((((1111))))
  269.  
  270.  
  271.  
  272.                   ...
  273.  
  274.       c,C:              Run move continuously.  "c" runs it
  275.                   forward, "C" runs    it backward.  When the
  276.                   movie reaches the    "end", it will
  277.                   immediately restart from the beginning.
  278.  
  279.       All continuing movie action can be halted by pressing    a key
  280.       or mouse button.
  281.  
  282.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  283.       _u_r_t(1), _R_L_E(5).
  284.  
  285.      AAAAUUUUTTTTHHHHOOOORRRR
  286.       Spencer W. Thomas, University    of Utah    (X10 version)
  287.  
  288.       Andrew F. Vesper, Digital Equipment Corp. (X11
  289.       modifications)
  290.  
  291.       Martin R. Friedmann, University of Michigan (better X11,
  292.       flipbook, magnification, info)
  293.  
  294.      BBBBUUUUGGGGSSSS
  295.       Display to a 24-bit visual is    somewhat optimized, but    could
  296.       be faster.
  297.  
  298.       Doesn't pay any attention to the X resource database (i.e.,
  299.       cannot be customized via the ._X_d_e_f_a_u_l_t_s file).  The options,
  300.       while    standard for the raster    toolkit, are non-standard for
  301.       X.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 12/1/98)
  328.  
  329.  
  330.  
  331.